home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_8 / issue_06 / risc_os / adfs / newADFS < prev    next >
Encoding:
Text File  |  1988-10-03  |  5.0 KB  |  147 lines
  1. 1. E format discs
  2.  a) don't need compacting
  3.  b) don't get map full errors
  4.  c) floppies can now also do defect skipping (was only winnies with old map)
  5.     as *format will map out any defects it finds
  6.  d) defects can mapped out without reformatting (both floppies and winnies)
  7.     using the command *defect <disc spec.> <disc add.>
  8.  
  9. 2. New configuration commands
  10.  
  11.    *configure ADFSDirCache <size> [K]
  12.     This reserves some space for ADFS to keep a cache of recently used
  13.     directories in a compressed form.
  14.  
  15.    *configure ADFSbuffers <buffers>
  16.     This is used to reserve a number of 1K buffers which ADFS can use to speed
  17.     up BGET, BPUT and GBPB. They are used for write behind, read ahead and
  18.     caching of most recently used file buffers. If underused some of this space
  19.     can get temporarily transferred to the directory cache. It does not have an
  20.     optional K in the syntax since each buffer has a small overhead and hence
  21.     the space reserved is not an exact number of Kbytes.
  22.  
  23. 3. *Verify will now do up to 5 retries, and report where it retried.
  24.    Typical output
  25.  
  26.    Verifying ...
  27.    0009A800  ??                        Managed to verify sector after 2 retries
  28.    Disc error 08 at :0.000C5400        Failed to verify sector after 5 retries
  29.    Verify failed
  30.  
  31.    Final message is one of
  32.     Verified ok
  33.     Verified with retries
  34.     Verify failed
  35.    Some discussion of soft and hard errors needed. This ties in with defects.
  36.  
  37. 4. RAMFS
  38.    The module RAMFS provides a filing system RAM: which appears to the user
  39.    much the same as ADFS.
  40.  
  41. 5. new adfs SWIs
  42.  
  43. ADFS_Retries &40244
  44.  
  45. This can be used to read/write the retry word, the 4 bytes of which have the
  46. following meaning.
  47. byte      meaning
  48. 0         number of retries for hard disc read/write sector
  49. 1         number of retries for floppy disc read/write sector
  50. 2         number of retries in floppy disc mount for each copy of map
  51. 3         number of retries for verify after *format before called a defect
  52.  
  53. entry
  54.  R0 bits to change
  55.  R1 new bits
  56.  
  57. exit
  58.  R0 preserved
  59.  R1 masked by R0 = R1 AND R0
  60.  R2 old value of retry word
  61.  R3 new value of retry word = (old value BIC R0) EOR (R1 AND R0)
  62.  
  63. ADFS_DescribeDisc &40245
  64.    entry
  65.     R0 -> disc specifier string
  66.     R1 -> 64 byte block to fill in as disc record
  67.  
  68.    exit
  69.     disc record filled in as follows
  70.       0 - log to base 2 of sector size
  71.       1 - sectors per track
  72.       2 - heads (1 for L format disc)
  73.       3 - density 1/2/4
  74.  
  75. *     4 - width of id field in bits
  76. *     5 - log to base 2 of bytes for each map bit or 0 for old map
  77. *     6 - track to track skew for random access files
  78.       7 - boot option
  79.  
  80.       8 - reserved
  81. *     9 - number of zones in the map
  82. * 10-11 - non map bits in zone
  83.  
  84.   12-15 - system internal number of root directory
  85.  
  86.   16-19 - disc size in bytes
  87.  
  88.   20-21 - 2 byte disc id
  89.   22-31 - disc name
  90.  
  91.   32-63 - reserved
  92.  
  93.         entries marked * refer to details of new map format
  94.  
  95. 6. Attribute extension
  96.    New directory discs (ie all except L format) have extended attributes.
  97.    Bits 4-7 no longer repeat bits 0-3, but the only use ADFS makes of them
  98.    is to display bits 4 and 5 in *FileInfo
  99.  
  100.    bit           meaning
  101.    0             owner read access
  102.    1             owner write access
  103.    2             always zero
  104.    3             locked bit
  105.    4             public read access
  106.    5             public write access
  107.    6             reserved
  108.    7             reserved
  109.  
  110. 7. extension of up call protocol
  111.    UpCall_MediaNotPresent (1) and UpCall_MediaNotKnown (2) have had their
  112.    parameters extended as below to allow the Wimp to detect insertion of a
  113.    disc if a drive supports disc changed.
  114.  
  115.    R1 -  filing system number
  116.    R2 -> media name string or -1 if irrelevant
  117.    R3 -  device number or -1 if irrelevant
  118.    R4 - iteration count 0,1,2,.. for repeated issuing of call
  119.    R5 - minimum polling period in centiseconds for claiming upcall,
  120.         -1 if not to poll
  121.    R6 -> media string eg. 'disc'
  122.  
  123. An up call handler for UpCall_MediaNotPresent and UpCall_MediaNotKnown can
  124. still work in the simple way. That is on receipt of the upcall to interact
  125. with the user to determine if he is able to insert the media. If he can then
  126. the handler should claim the upcall, otherwise it should pass it on. The
  127. up call will be repeatedly issued until the media is found or the up call not
  128. claimed. 
  129.  
  130. In order to spot automatically when the required media has been inserted. The
  131. upcall handler should regularly claim the up call at intervals specifed by R5
  132. allowing the filing system to search for the media. In order to allow the
  133. up call handler to tidy up if a media is found in this way a new up call,
  134. UpCall_MediaSearchEnd (4), has been added. This is issued whenever a media
  135. search is ended, either because the media was found or the up call was not
  136. claimed.
  137.  
  138. This up call handler must not issue calls that may cause the filing system to
  139. be re-entered. Also programs designed to run under the desktop should not
  140. handle these up_calls.
  141.  
  142. 8. Creating a new filing system with FileCore.
  143.    see separate document
  144.  
  145. 9. Details of E format file structure
  146.    see separate document
  147.